home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / libelfutil / xlate_pro_disk_header.z / xlate_pro_disk_header
Text File  |  1998-10-30  |  12KB  |  198 lines
  1.  
  2.  
  3.  
  4. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____DDDDIIIISSSSKKKK____HHHHEEEEAAAADDDDEEEERRRR((((3333EEEE))))                            XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____DDDDIIIISSSSKKKK____HHHHEEEEAAAADDDDEEEERRRR((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______hhhh_eeee_aaaa_dddd_eeee_rrrr - get translation byte stream block count
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_eeee_llll_ffff_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_dddd_wwww_aaaa_rrrr_ffff_...._hhhh_>>>>
  16.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_mmmm_pppp_llll_rrrr_ssss_////_xxxx_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  17.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_XXXX_llll_aaaa_tttt_eeee_...._hhhh_>>>>
  18.      _iiii_nnnn_tttt _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______hhhh_eeee_aaaa_dddd_eeee_rrrr_((((_xxxx_llll_aaaa_tttt_eeee______tttt_aaaa_bbbb_llll_eeee______pppp_rrrr_oooo _pppp_rrrr_oooo______tttt_aaaa_bbbb_llll_eeee______pppp_tttt_rrrr_,,,,
  19.        _iiii_nnnn_tttt          _ssss_tttt_aaaa_nnnn_dddd_aaaa_rrrr_dddd______oooo_rrrr______dddd_eeee_bbbb_uuuu_gggg_,,,,
  20.        _EEEE_llll_ffff_6666_4444______XXXX_wwww_oooo_rrrr_dddd _****_tttt_oooo_tttt_aaaa_llll______mmmm_eeee_mmmm_oooo_rrrr_yyyy______rrrr_eeee_qqqq_uuuu_iiii_rrrr_eeee_dddd_,,,,
  21.        _EEEE_llll_ffff_6666_4444______XXXX_wwww_oooo_rrrr_dddd _****_nnnn_uuuu_mmmm_bbbb_eeee_rrrr______oooo_ffff______bbbb_llll_oooo_cccc_kkkk_ssss
  22.      _))))_;;;;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      This function gets the total size and the number-of-blocks of either the
  26.      standard or debug stream of data.  Following this one calls
  27.      _x_l_a_t_e__p_r_o__d_i_s_k__b_l_o_c_k number-of-blocks times to get pointers the blocks of
  28.      actual data bytes of the byte stream.  The library does not write
  29.      anything to disk.  It is up to the application calling the library to
  30.      write the information to disk (or to do whatever else is appropriate with
  31.      the byte stream).
  32.  
  33.      _x_l_a_t_e__p_r_o__d_i_s_k__h_e_a_d_e_r gets the size of the net translation table data
  34.      stream thru the pointer arguments.
  35.  
  36.      If there are no translation ranges supplied but there  is register
  37.      information supplied (or if there is a consumer translation table
  38.      supplied) an output stream may have non-zero length and block count but
  39.      such a stream is surely useless.
  40.  
  41.      If there are no translations the block count and length will be returned
  42.      as 0 (see below).
  43.  
  44.      The arguments are a as follows.
  45.  
  46.      _p_r_o__t_a_b_l_e__p_t_r must be a valid open producer translate table handle.
  47.  
  48.      _s_t_a_n_d_a_r_d__o_r__d_e_b_u_g specifies whether the byte stream returned by calls to
  49.      _x_l_a_t_e__p_r_o__d_i_s_k__n_e_x_t__b_l_o_c_k is the standard or debug stream.  Call with
  50.      _X_L_A_T_E__P_R_O__S_T_A_N_D_A_R_D__S_E_T_U_P to request the standard stream.  Call with
  51.      _X_L_A_T_E__P_R_O__D_E_B_U_G__S_E_T_U_P to request the debug stream.
  52.  
  53.      _t_o_t_a_l__m_e_m_o_r_y__r_e_q_u_i_r_e_d
  54.              The pointed at memory is set to the total number of bytes in the
  55.              translation byte stream.  If there is no translation data the
  56.              pointed at memory will be set to 0.
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____DDDDIIIISSSSKKKK____HHHHEEEEAAAADDDDEEEERRRR((((3333EEEE))))                            XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____DDDDIIIISSSSKKKK____HHHHEEEEAAAADDDDEEEERRRR((((3333EEEE))))
  70.  
  71.  
  72.  
  73.      _n_u_m_b_e_r__o_f__b_l_o_c_k_s
  74.              The pointed at memory is set to the number of calls of
  75.              _x_l_a_t_e__p_r_o__d_i_s_k__n_e_x_t__b_l_o_c_k required to get pointers to the pieces
  76.              of the byte stream.  If there is no translation data the pointed
  77.              at memory will be set to 0.
  78.  
  79.      An example showing typical use of these functions follows.
  80.  
  81.           _rrrr_eeee_ssss _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______hhhh_eeee_aaaa_dddd_eeee_rrrr_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_,,,,
  82.                  _XXXX_LLLL_AAAA_TTTT_EEEE______PPPP_RRRR_OOOO______SSSS_TTTT_AAAA_NNNN_DDDD_AAAA_RRRR_DDDD______SSSS_EEEE_TTTT_UUUU_PPPP_,,,,
  83.                      _&&&&_tttt_oooo_tttt_mmmm_eeee_mmmm_,,,,_&&&&_bbbb_llll_kkkk______cccc_tttt_))))_;;;;
  84.           _ffff_oooo_rrrr_(((( _iiii _==== _0000_;;;; _iiii _<<<< _bbbb_llll_kkkk______cccc_tttt_;;;; _++++_++++_iiii _))))
  85.           _{{{{
  86.             _rrrr_eeee_ssss _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______nnnn_eeee_xxxx_tttt______bbbb_llll_oooo_cccc_kkkk_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_,,,,
  87.                       _&&&&_dddd_aaaa_tttt_aaaa_pppp_,,,,_&&&&_dddd_aaaa_tttt_aaaa______ssss_iiii_zzzz_eeee_))))_;;;;
  88.             _////_**** _dddd_oooo _ssss_oooo_mmmm_eeee_tttt_hhhh_iiii_nnnn_gggg _wwww_iiii_tttt_hhhh _tttt_hhhh_eeee _bbbb_yyyy_tttt_eeee_ssss_****_////
  89.             _ffff_rrrr_eeee_eeee_((((_dddd_aaaa_tttt_aaaa_pppp_))))_;;;;
  90.           _}}}}
  91.           _rrrr_eeee_ssss _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______hhhh_eeee_aaaa_dddd_eeee_rrrr_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_,,,,
  92.                  _XXXX_LLLL_AAAA_TTTT_EEEE______PPPP_RRRR_OOOO______DDDD_EEEE_BBBB_UUUU_GGGG______SSSS_EEEE_TTTT_UUUU_PPPP
  93.                      _&&&&_tttt_oooo_tttt_mmmm_eeee_mmmm_dddd_eeee_bbbb_uuuu_gggg_,,,,_&&&&_bbbb_llll_kkkk______cccc_tttt_dddd_eeee_bbbb_uuuu_gggg_))))_;;;;
  94.           _ffff_oooo_rrrr_(((( _iiii _==== _0000_;;;; _iiii _<<<< _bbbb_llll_kkkk______cccc_tttt_dddd_eeee_bbbb_uuuu_gggg_;;;; _++++_++++_iiii _))))
  95.           _{{{{
  96.             _rrrr_eeee_ssss _==== _xxxx_llll_aaaa_tttt_eeee______pppp_rrrr_oooo______dddd_iiii_ssss_kkkk______nnnn_eeee_xxxx_tttt______bbbb_llll_oooo_cccc_kkkk_((((_pppp_rrrr_oooo______tttt_aaaa_bbbb_,,,,
  97.                   _&&&&_dddd_aaaa_tttt_aaaa_pppp_,,,,_&&&&_dddd_aaaa_tttt_aaaa______ssss_iiii_zzzz_eeee_))))_;;;;
  98.             _////_**** _dddd_oooo _ssss_oooo_mmmm_eeee_tttt_hhhh_iiii_nnnn_gggg _wwww_iiii_tttt_hhhh _tttt_hhhh_eeee _bbbb_yyyy_tttt_eeee_ssss_****_////
  99.             _ffff_rrrr_eeee_eeee_((((_dddd_aaaa_tttt_aaaa_pppp_))))_;;;;
  100.           _}}}}
  101.  
  102. FFFFIIIILLLLEEEESSSS
  103.      /usr/include/libXlate.h
  104.      /usr/include/cmplrs/xlate.h
  105.      /usr/include/elf.h
  106.      /usr/include/dwarf.h
  107.      /usr/include/libdwarf.h
  108.      /usr/lib/libelfutil.a
  109.  
  110. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  111.      This returns XLATE_TB_STATUS_NO_ERROR (0) on success.  In case of error,
  112.      a negative number is returned indicating the error.  In case of error
  113.      nothing is returned thru the pointer arguments.
  114.  
  115.      Error returns possible are:
  116.  
  117.      _X_L_A_T_E__T_B__S_T_A_T_U_S__I_N_V_A_L_I_D__T_A_B_L_E
  118.              means that that the _t_a_b_l_e is not a valid open producer handle.
  119.  
  120.      _X_L_A_T_E__T_B__S_T_A_T_U_S__P_R_O__R_E_Q__I_N_V_A_L_I_D
  121.              means that the _s_t_a_n_d_a_r_d__o_r__d_e_b_u_g argument is neither
  122.              _X_L_A_T_E__P_R_O__S_T_A_N_D_A_R_D__S_E_T_U_P nor _X_L_A_T_E__P_R_O__D_E_B_U_G__S_E_T_U_P.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____DDDDIIIISSSSKKKK____HHHHEEEEAAAADDDDEEEERRRR((((3333EEEE))))                            XXXXLLLLAAAATTTTEEEE____PPPPRRRROOOO____DDDDIIIISSSSKKKK____HHHHEEEEAAAADDDDEEEERRRR((((3333EEEE))))
  136.  
  137.  
  138.  
  139. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  140.      libelfutil(5), xlate(4), xlate_pro_init(3e), xlate_pro_finish(3e),
  141.      xlate_pro_disk_next_block(3e),
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.